Summary

The grid Clipboard docs page already exists, but its onCopy example was broken — it referenced functions that don't exist (serializeAsTsv / serializeAsHtmlTable) and the wrong argument shape ({ ranges, snapshot }). It also claimed onCopy could return a bare string, which the type doesn't allow.

This aligns the page with the actual @public copy API (the symbols PR 3 committed to as stable).

The real API (verified in packages/react/src/copy.ts + pretable-surface.tsx)

onCopy?: (args: SerializeRangesArgs<TRow>) => CopyPayload | null;
copyToClipboard?: (payload: CopyPayload) => void | Promise<void>;

interface SerializeRangesArgs<TRow> {
  ranges: readonly PretableCellRange[];
  visibleRows: readonly PretableVisibleRow<TRow>[];
  columns: readonly PretableColumn<TRow>[];
  copyWithHeaders?: boolean;
}
interface CopyPayload { text: string; html?: string }
function defaultCoerceForCopy(value: unknown): string;
function serializeRangesAsTsv<TRow>(args: SerializeRangesArgs<TRow>): CopyPayload | null;

Changes

• Fix the onCopy example → real serializeRangesAsTsv + correct SerializeRangesArgs shape (a working TSV→CSV override).
• Correct the return-type docs → CopyPayload | null, not a bare string.
• New "Building your own serializer" section → documents SerializeRangesArgs's fields and defaultCoerceForCopy (both @public, previously undocumented).
• Document the copyToClipboard prop (also @public, previously undocumented).

Gates

• Website docs-validation tests pass (lib/docs enumerate/load/search-index + llms.txt build) — 21 passed
• prettier --check clean
• Internal anchor (#default-tsv-format) and cross-links verified to exist

🤖 Generated with Claude Code